Here's March! 

This month we're including a small quest- 
ionnaire on what sort of people and equipment 
are out there in subscriberland. If you 
could take a moment, fill it out and return 
it to us, we will have a good idea of the 
things we can do to serve you better. Not 
that we're promising anything... 
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"Birthday" is happy birthday to us, written by our editor of two 
summers back. Placing an AM radio next to the keyboard unit lets you 
listen to the somewhat tremulous voice of the computer singing along. 
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"YahtZ-80" is essentially a poker game played with simulated dice. 
You are handed a "roll" and have two chances to improve it by identifying 
a die (by number) and pressing "R" . If you're happy before your two rolls 
are up, press "R" without first selecting a die. You now have the choice 
of selecting which category to place your hand (twos, threes, full house, 
etc.). In the course of a game, each player must classify precisely 
thirteen hands into the thirteen different categories. The computer 
scores the totals, delivers the verdict, and locks up. To replay, press 
"BREAK" and type "RUN" again. 
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"Nerves" is a good exercise for those of you who are suffering from 
peace, happiness, quiet living and kind thoughts. The obiect of the game 
is to get your rat through the maze as quickly as possible, with the mini- 
mum number of commands. It is considered poor manners to poke your fist 
through the screen. As an example of skill, my highest score (cold sober) 
is 108. 

"Level 3" is the prize this month, folks. It is a system file, so it 
needs memory reserved. To load it, turn on your computer, and enter 31100 
for MEMORY SIZE. Then enter "SYSTEM" and "LEVEL3" and play the tape. 
When (if?) the SYSTEM prompt . returns , enter a "/ (enter)".' The instruc- 
tions will slowly form on the screen. BASICally, the system traps out 
error messages and expands them to a more readable form, and also provides 
the ability to store strings of up to twenty bytes under each alphabet key 
(it is typed automatically when the key is typed shifted). After this 
file is loaded, you can proceed to use your computer to program in a 
normal fashion, keeping in mind that the upper 1667 bytes of memory are 
already spoken for. 

As promised last month, I'd like to finish up on the subject of ma- 
chine code CALLS with the introduction of interrupts. 

We left off having explained the CALL <address> instruction and how it 
automatically saves its place in the program so it knows where to come 
back to when told to RETurn. If the machine language subroutine that is 
CALLed saves all of the registers in memory somewhere, and resets them to 
the way it found them before RETurning, the main program will never know 
that a subroutine was called, and what it doesn't know won't hurt it. 

Imagine the following situation: the TRS-80 (lets presume it is a disk 
system with a real time clock) is merrily computing along in the middle of 
a_game, and the system clock hardware ticks (that's all it can do - tick, 
tick, tick). The actual clock is built in software - that's where the 
seconds, minutes, hours and so forth are kept updated. The user is not 
expected to always run programs which occasionally qo out and look to see 
if the clock has ticked lately. The clock is set" up to steal the time 
from the program that is currently being executed by - guess how? - "in- 
terrupting" the computer. 

It turns out that there is a pin on the expansion interface connector 
(pin 21, INT*) that normally floats through life at a +5 volt level. When 
a piece of external hardware (such as the expansion interface) wants to 
interrupt the program in progress, it simply pulls the voltage at this pin 
down to ground (a pushbutton switch would work, too). Pulling this pin 
low has exactly the same effect' as magically inserting a CALL 0038 (Hex) 
instruction. 

Address 0038 (Hex) is in Read Only Memory, so it is not surprising to 
find a JP 4012(Hex) instruction there. O.K, let's jump to 4012 (Hex) ' and 
there's yet another JP instruction, this time to the Real Time Clock sub- 
routine. The Real Time Clock is a subroutine that saves all the regis- 
ters that it uses and restores them prior to RETurning, so it is an 
"invisible" interrupt. The main program doesn't ever feel it. 

Let's step through the sequence one last time., The Z-80 chip is 
churning merrily along in the middle of some program, it doesn't matter 
what or where. Suddenly there is a Real Time Clock tick, and a hardware 
gate pulls the INT* line on the expansion connector to zero volts. The 
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Z-80 chip interprets this as a CALL instruction to address 0038 (Hex)'. It 
pushes its current program address on the stack, and jumps to address 
0038(Hex). There it finds a jump to address 4012(Hexj, so it does that. 
Arriving at 4012(Hex), it finds yet even another jump, this time to the 
Real Time Clock subroutine. The Z-80 finally arrives at the ETC subrou- 
tine, increments the seconds count (or whatever...) and RETurns to the 
main program by popping the address from the top of the stack. 

Why all that jumping around? Well, the address 0038 (Hex) was decreed 
by the designers of the Z-80 chip. In the TRS-80, that happens to be in 
the Read Only Memory, so the user cannot POKE a subroutine there. The 
codesmiths who wrote the level II BASIC decided to jump out to RAM (read- 
write memory), hence the JP 4012(Hex) instruction,, These codesmiths re- 
served three bytes of RAM at 4012 (Hex) so that a user could POKE a 
subroutine anywhere in RAM, and then POKE a jump to it in these three 
bytes. When the machine is first turned on, there is no interrupt 
subroutine anywhere in memory, so the three bytes at 4012 (Hex) merely 
RETurn control back to whatever the main routine is. 

One final word. Interrupts can be enabled or disabled with the EI or 
DI instructions, respectively. Executing a Disable Interrupts instruction 
will cause the Z-80 to defer looking at the INT* pin until the next Enable 
Interrupts instruction is executed (which could be never) . When the Z-80 
chip responds to an interrupt, it automatically disables the interrupts, 
so the last instruction (right before the RETurn instruction) in an inter- 
rupt subroutine should be an Enable Interrupts instruction (Opcode = 
FB(Hex) ) . 

(over) 



Questionnaire: please fill out and return this form to CLOAD Magazine 
(note - if you object to tearing up your yellow sheets, just send us a 
note with the multiple guess answers - We'll be keying it all into a 
computer anyway) . 

Type of computer ( level I or level II) 

Amount of memory ( in K's) 

Do you have an expansion interface? (y/n) 

Printer? (y/n) 

Disk(s)? (y/n) 

Do you do a lot of your own programming? (y/n) 



What is your current main use of your computer? (B=business, 
E=education, F=f un £ games, D=software development, O=other) 

For what use did you 'purchase your computer? (B=business, 
E=education, F=fun€ games, D=software development, O=other) 

How many different people might use your computer in a typical 
week? 
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One hangup that a few of you expansion interface users may have 'been 
running into involves what happens when (1) someone has borrowed your 
printer or you don't own a printer, or your non-Centronics/Radio Shack 
style printer driver hasn't been patched during this session, and (2) a 
program you are using executes an LPRINT command. What BASIC will do is 
go out to the parallel printer port and wait until the port is ready, 
which takes forever if there's no printer plugged in. The only exit in 
such cases involves restarting the system. There are several solutions. 
One is to always have a printer plugged into your parallel port. Another 
is never to use the LPRINT statement in a program when there's no printer 
around. For those of you who find both these solutions difficult, there 
is a "dummy" parallel printer plug available from Fuller Electronics (7465 
Hollister #232, Goleta CA 93017) that acts as a hit bucket. It's twelve 
bucks, which may seem a lot to do nothing but throw away bits, but if 
you're hung up on hangups, it's far cheaper than psychotherapy. 

Also in our Miscellaneous Dinguses (dingii?) column this month, E.B. 
Garcia and Associates (203 N. Wabash, Rm. 2102 Chicago IL 60601) has come 
out with a cute little plunger thingie that extends the RESET button in 
the back of the computer out past the expansion interface cable connector. 
This replaces the curse - stand up - grab pencil - poke pencil in behind 
expansion plug sequence that sometimes occurs. 

Next month! 

Ralph McE]coy, Publisher 
:::::::::::::::::::::::::::::::::::::::::::::::::<:::::::::::::::::::::::: 

questionnaire (cont.) 

How many times do you use your computer in a week? 

Have you had trouble loading our cassettes in the last six months 

or so? (y/n) 
Has the Postal Service lost, crunched, or otherwise done evil things 

to your cassettes? (y/n) 
How long have you been "into computing"? (months) 

How many people have been introduced to computing on your -machine? 

0n a scale of l=poor to 9=good, how would you rate CLOAD overall? 

On the same scale, how would you rate your favorite software pack- 
age? (besides us, that is) 

Have you had any trouble with any of our advertisers? 

(if so, which one?) 

What has been your favorite program? 

What do like most about CLOAD Magazine? 

What do you like least about CLOAD Magazine? 



